Manager: Control Manager


Carbon will fully support the Control Manager, with the following changes:

* The C-style, lowercase versions of Control Manager function names are no longer supported. If your application uses any Control Manager lowercase function names, you must replace them with their uppercase equivalents.

* Custom control definition procedures (also known as CDEFs), must be compiled as PowerPC-native code, and can not be stored as resources. See the Carbon Porting Guide for more information.

* Your application must use the functions defined by the Control Manager whenever your application needs to create and dispose of Control Manager data structures. For example, instead of directly creating and disposing of control records, applications must call the Control Manager functions GetNewControl and DisposeControl.

* Your application must use Control Manager accessor functions to accesses Control Manager data structures.

* You are encouraged to adopt the standard Mac OS control definition procedures in your application. Applications that use the standard control definition procedures inherit the Mac OS human interface appearance. Applications that use custom control definition procedures will work correctly, but because custom definition procedures invoke their own drawing routines, Mac OS 8 can't draw these applications with the current appearance.

Supported  ActivateControl

Under Evaluation  AddDataBrowserItems

Under Evaluation  AddDataBrowserListViewColumn

Under Evaluation  AddDataBrowserTableViewColumn

Supported  AdvanceKeyboardFocus

Supported  AutoEmbedControl

Under Evaluation  AutoSizeDataBrowserListViewColumns

Supported  CallControlActionProc

Supported  CallControlDefProc

Supported  CallControlEditTextValidationProc

Supported  CallControlKeyFilterProc

Supported  CallControlUserPaneActivateProc

Supported  CallControlUserPaneBackgroundProc

Supported  CallControlUserPaneDrawProc

Supported  CallControlUserPaneFocusProc

Supported  CallControlUserPaneHitTestProc

Supported  CallControlUserPaneIdleProc

Supported  CallControlUserPaneKeyDownProc

Supported  CallControlUserPaneTrackingProc

Under Evaluation  ChangeControlPropertyAttributes

Supported  ClearKeyboardFocus

Under Evaluation  CloseDataBrowserContainer

Supported  ControlActionProcPtr

Under Evaluation  ControlCNTLToCollectionProcPtr

Supported  ControlDefProcPtr

Supported  ControlEditTextValidationProcPtr

Supported  ControlKeyFilterProcPtr

Unsupported  ControlNotificationProcPtr

QuickTime control notification functions are not supported in Carbon.

Supported  ControlUserPaneActivateProcPtr

Supported  ControlUserPaneBackgroundProcPtr

Supported  ControlUserPaneDrawProcPtr

Supported  ControlUserPaneFocusProcPtr

Supported  ControlUserPaneHitTestProcPtr

Supported  ControlUserPaneIdleProcPtr

Supported  ControlUserPaneKeyDownProcPtr

Supported  ControlUserPaneTrackingProcPtr

Under Evaluation  CopyControlTitleAsCFString

Supported  CountSubControls

Under Evaluation  CreateBevelButtonControl

Under Evaluation  CreateChasingArrowsControl

Under Evaluation  CreateCheckBoxControl

Under Evaluation  CreateCheckGroupBoxControl

Under Evaluation  CreateClockControl

Under Evaluation  CreateCustomControl

Under Evaluation  CreateDataBrowserControl

Under Evaluation  CreateDisclosureTriangleControl

Under Evaluation  CreateEditTextControl

Under Evaluation  CreateGroupBoxControl

Under Evaluation  CreateIconControl

Under Evaluation  CreateImageWellControl

Under Evaluation  CreateListBoxControl

Under Evaluation  CreateLittleArrowsControl

Under Evaluation  CreatePictureControl

Under Evaluation  CreatePlacardControl

Under Evaluation  CreatePopupArrowControl

Under Evaluation  CreatePopupButtonControl

Under Evaluation  CreatePopupGroupBoxControl

Under Evaluation  CreateProgressBarControl

Under Evaluation  CreatePushButtonControl

Under Evaluation  CreatePushButtonWithIconControl

Under Evaluation  CreateRadioButtonControl

Under Evaluation  CreateRadioGroupControl

Supported  CreateRootControl

Under Evaluation  CreateScrollBarControl

Under Evaluation  CreateScrollingTextBoxControl

Under Evaluation  CreateSeparatorControl

Under Evaluation  CreateSliderControl

Under Evaluation  CreateStaticTextControl

Under Evaluation  CreateTabsControl

Under Evaluation  CreateUserPaneControl

Under Evaluation  CreateWindowHeaderControl

Under Evaluation  DataBrowserAcceptDragProcPtr

Under Evaluation  DataBrowserAddDragItemProcPtr

Under Evaluation  DataBrowserCompareProcPtr

Under Evaluation  DataBrowserDrawItemProcPtr

Under Evaluation  DataBrowserEditItemProcPtr

Under Evaluation  DataBrowserGetContextualMenuProcPtr

Under Evaluation  DataBrowserGetHelpContentProcPtr

Under Evaluation  DataBrowserGetSetItemDataProcPtr

Under Evaluation  DataBrowserHitTestProcPtr

Under Evaluation  DataBrowserItemAcceptDragProcPtr

Under Evaluation  DataBrowserItemDragRgnProcPtr

Under Evaluation  DataBrowserItemNotificationProcPtr

Under Evaluation  DataBrowserItemProcPtr

Under Evaluation  DataBrowserItemReceiveDragProcPtr

Under Evaluation  DataBrowserPostProcessDragProcPtr

Under Evaluation  DataBrowserReceiveDragProcPtr

Under Evaluation  DataBrowserSelectContextualMenuProcPtr

Under Evaluation  DataBrowserTrackingProcPtr

Supported  DeactivateControl

Supported  DisposeControl

Supported  DisposeControlActionUPP

Under Evaluation  DisposeControlCNTLToCollectionUPP

Supported  DisposeControlDefUPP

Supported  DisposeControlEditTextValidationUPP

Supported  DisposeControlKeyFilterUPP

Supported  DisposeControlUserPaneActivateUPP

Supported  DisposeControlUserPaneBackgroundUPP

Supported  DisposeControlUserPaneDrawUPP

Supported  DisposeControlUserPaneFocusUPP

Supported  DisposeControlUserPaneHitTestUPP

Supported  DisposeControlUserPaneIdleUPP

Supported  DisposeControlUserPaneKeyDownUPP

Supported  DisposeControlUserPaneTrackingUPP

Under Evaluation  DisposeDataBrowserAcceptDragUPP

Under Evaluation  DisposeDataBrowserAddDragItemUPP

Under Evaluation  DisposeDataBrowserCompareUPP

Under Evaluation  DisposeDataBrowserDrawItemUPP

Under Evaluation  DisposeDataBrowserEditItemUPP

Under Evaluation  DisposeDataBrowserGetContextualMenuUPP

Under Evaluation  DisposeDataBrowserGetHelpContentUPP

Under Evaluation  DisposeDataBrowserGetSetItemDataUPP

Under Evaluation  DisposeDataBrowserHitTestUPP

Under Evaluation  DisposeDataBrowserItemAcceptDragUPP

Under Evaluation  DisposeDataBrowserItemDragRgnUPP

Under Evaluation  DisposeDataBrowserItemNotificationUPP

Under Evaluation  DisposeDataBrowserItemReceiveDragUPP

Under Evaluation  DisposeDataBrowserItemUPP

Under Evaluation  DisposeDataBrowserPostProcessDragUPP

Under Evaluation  DisposeDataBrowserReceiveDragUPP

Under Evaluation  DisposeDataBrowserSelectContextualMenuUPP

Under Evaluation  DisposeDataBrowserTrackingUPP

Supported  DragControl

Unsupported  dragcontrol

Use DragControl instead.

Supported  Draw1Control

Supported  DrawControlInCurrentPort

Supported  DrawControls

Supported  DumpControlHierarchy

Supported  EmbedControl

Under Evaluation  EnableDataBrowserEditCommand

Under Evaluation  ExecuteDataBrowserEditCommand

Supported  FindControl

Unsupported  findcontrol

Use FindControl instead.

Supported  FindControlUnderMouse

Under Evaluation  FlattenControl

Under Evaluation  ForEachDataBrowserItem

Supported  GDBShowControlHierarchy

Supported  GDBShowControlInfo

Supported  GetAuxiliaryControlRecord

Supported  GetBestControlRect

Supported  GetBevelButtonContentInfo

Supported  GetBevelButtonMenuHandle

Supported  GetBevelButtonMenuValue

Supported  GetControl32BitMaximum

Supported  GetControl32BitMinimum

Supported  GetControl32BitValue

Supported  GetControlAction

Supported  GetControlBounds

Under Evaluation  GetControlByID

Unsupported  GetControlColorTable

Custom control color tables are not supported in Carbon.

Unsupported  GetControlComponentInstance

This QuickTime function for manipulating controls is not supported in Carbon.

Supported  GetControlData

Supported  GetControlDataHandle

Supported  GetControlDataSize

Supported  GetControlDefinition

Supported  GetControlFeatures

Unsupported  GetControlHandleFromCookie

This QuickTime function for manipulating controls is not supported in Carbon.

Supported  GetControlHilite

Under Evaluation  GetControlID

Supported  GetControlMaximum

Supported  GetControlMinimum

Supported  GetControlOwner

Unsupported  GetControlOwningWindowControlList

Supported  GetControlPopupMenuHandle

Supported  GetControlPopupMenuID

Supported  GetControlProperty

Under Evaluation  GetControlPropertyAttributes

Supported  GetControlPropertySize

Supported  GetControlReference

Supported  GetControlRegion

Supported  GetControlTitle

Unsupported  getcontroltitle

Use GetControlTitle instead.

Supported  GetControlValue

Supported  GetControlVariant

Supported  GetControlViewSize

Supported  GetDataBrowserActiveItems

Under Evaluation  GetDataBrowserCallbacks

Under Evaluation  GetDataBrowserCustomCallbacks

Under Evaluation  GetDataBrowserEditData

Under Evaluation  GetDataBrowserEditItem

Under Evaluation  GetDataBrowserHasScrollBars

Under Evaluation  GetDataBrowserItemCount

Under Evaluation  GetDataBrowserItemDataBooleanValue

Under Evaluation  GetDataBrowserItemDataButtonValue

Under Evaluation  GetDataBrowserItemDataMaximum

Under Evaluation  GetDataBrowserItemDataMinimum

Under Evaluation  GetDataBrowserItemDataText

Under Evaluation  GetDataBrowserItemDataValue

Under Evaluation  GetDataBrowserItems

Under Evaluation  GetDataBrowserItemState

Under Evaluation  GetDataBrowserListViewDisclosureColumn

Under Evaluation  GetDataBrowserListViewHeaderBtnHeight

Under Evaluation  GetDataBrowserListViewUsePlainBackground

Under Evaluation  GetDataBrowserScrollBarInset

Under Evaluation  GetDataBrowserScrollPosition

Under Evaluation  GetDataBrowserSelectionAnchor

Under Evaluation  GetDataBrowserSelectionFlags

Under Evaluation  GetDataBrowserSortOrder

Under Evaluation  GetDataBrowserSortProperty

Under Evaluation  GetDataBrowserTableViewColumnCount

Under Evaluation  GetDataBrowserTableViewColumnPosition

Under Evaluation  GetDataBrowserTableViewColumnProperty

Under Evaluation  GetDataBrowserTableViewColumnWidth

Under Evaluation  GetDataBrowserTableViewGeometry

Under Evaluation  GetDataBrowserTableViewHiliteStyle

Under Evaluation  GetDataBrowserTableViewItemID

Under Evaluation  GetDataBrowserTableViewItemRow

Under Evaluation  GetDataBrowserTableViewItemRowHeight

Under Evaluation  GetDataBrowserTableViewNamedColumnWidth

Under Evaluation  GetDataBrowserTableViewRowHeight

Under Evaluation  GetDataBrowserTarget

Under Evaluation  GetDataBrowserUserState

Under Evaluation  GetDataBrowserViewStyle

Supported  GetImageWellContentInfo

Supported  GetIndexedSubControl

Supported  GetKeyboardFocus

Supported  GetNewControl

Unsupported  GetNextControl

The GetNextControl function is not supported in Carbon. Use the Control Manager's embedding hierarchy functions (CreateRootControl, GetRootControl, EmbedControl, AutoEmbedControl, GetSuperControl, GetIndexedSubControl, and SetControlSupervisor) to determine control ordering instead.

Supported  GetRootControl

Supported  GetSuperControl

Supported  GetTabContentRect

Supported  HandleControlClick

Under Evaluation  HandleControlContextualMenuClick

Under Evaluation  HandleControlDragReceive

Under Evaluation  HandleControlDragTracking

Supported  HandleControlKey

Under Evaluation  HandleControlSetCursor

Supported  HideControl

Supported  HiliteControl

Supported  IdleControls

Under Evaluation  InitDataBrowserCallbacks

Under Evaluation  InitDataBrowserCustomCallbacks

Supported  InvokeControlActionUPP

Under Evaluation  InvokeControlCNTLToCollectionUPP

Supported  InvokeControlDefUPP

Supported  InvokeControlEditTextValidationUPP

Supported  InvokeControlKeyFilterUPP

Supported  InvokeControlUserPaneActivateUPP

Supported  InvokeControlUserPaneBackgroundUPP

Supported  InvokeControlUserPaneDrawUPP

Supported  InvokeControlUserPaneFocusUPP

Supported  InvokeControlUserPaneHitTestUPP

Supported  InvokeControlUserPaneIdleUPP

Supported  InvokeControlUserPaneKeyDownUPP

Supported  InvokeControlUserPaneTrackingUPP

Under Evaluation  InvokeDataBrowserAcceptDragUPP

Under Evaluation  InvokeDataBrowserAddDragItemUPP

Under Evaluation  InvokeDataBrowserCompareUPP

Under Evaluation  InvokeDataBrowserDrawItemUPP

Under Evaluation  InvokeDataBrowserEditItemUPP

Under Evaluation  InvokeDataBrowserGetContextualMenuUPP

Under Evaluation  InvokeDataBrowserGetHelpContentUPP

Under Evaluation  InvokeDataBrowserGetSetItemDataUPP

Under Evaluation  InvokeDataBrowserHitTestUPP

Under Evaluation  InvokeDataBrowserItemAcceptDragUPP

Under Evaluation  InvokeDataBrowserItemDragRgnUPP

Under Evaluation  InvokeDataBrowserItemNotificationUPP

Under Evaluation  InvokeDataBrowserItemReceiveDragUPP

Under Evaluation  InvokeDataBrowserItemUPP

Under Evaluation  InvokeDataBrowserPostProcessDragUPP

Under Evaluation  InvokeDataBrowserReceiveDragUPP

Under Evaluation  InvokeDataBrowserSelectContextualMenuUPP

Under Evaluation  InvokeDataBrowserTrackingUPP

Under Evaluation  IsAutomaticControlDragTrackingEnabledForWindow

Supported  IsControlActive

Under Evaluation  IsControlDragTrackingEnabled

Supported  IsControlHilited

Supported  IsControlVisible

Under Evaluation  IsDataBrowserItemSelected

Supported  IsValidControlHandle

Supported  KillControls

Supported  MoveControl

Under Evaluation  MoveDataBrowserSelectionAnchor

Supported  NewControl

Unsupported  newcontrol

Use NewControl instead.

Supported  NewControlActionProc

Supported  NewControlActionUPP

Under Evaluation  NewControlCNTLToCollectionUPP

Supported  NewControlDefProc

Supported  NewControlDefUPP

Supported  NewControlEditTextValidationProc

Supported  NewControlEditTextValidationUPP

Supported  NewControlKeyFilterProc

Supported  NewControlKeyFilterUPP

Supported  NewControlUserPaneActivateProc

Supported  NewControlUserPaneActivateUPP

Supported  NewControlUserPaneBackgroundProc

Supported  NewControlUserPaneBackgroundUPP

Supported  NewControlUserPaneDrawProc

Supported  NewControlUserPaneDrawUPP

Supported  NewControlUserPaneFocusProc

Supported  NewControlUserPaneFocusUPP

Supported  NewControlUserPaneHitTestProc

Supported  NewControlUserPaneHitTestUPP

Supported  NewControlUserPaneIdleProc

Supported  NewControlUserPaneIdleUPP

Supported  NewControlUserPaneKeyDownProc

Supported  NewControlUserPaneKeyDownUPP

Supported  NewControlUserPaneTrackingProc

Supported  NewControlUserPaneTrackingUPP

Under Evaluation  NewDataBrowserAcceptDragUPP

Under Evaluation  NewDataBrowserAddDragItemUPP

Under Evaluation  NewDataBrowserCompareUPP

Under Evaluation  NewDataBrowserDrawItemUPP

Under Evaluation  NewDataBrowserEditItemUPP

Under Evaluation  NewDataBrowserGetContextualMenuUPP

Under Evaluation  NewDataBrowserGetHelpContentUPP

Under Evaluation  NewDataBrowserGetSetItemDataUPP

Under Evaluation  NewDataBrowserHitTestUPP

Under Evaluation  NewDataBrowserItemAcceptDragUPP

Under Evaluation  NewDataBrowserItemDragRgnUPP

Under Evaluation  NewDataBrowserItemNotificationUPP

Under Evaluation  NewDataBrowserItemReceiveDragUPP

Under Evaluation  NewDataBrowserItemUPP

Under Evaluation  NewDataBrowserPostProcessDragUPP

Under Evaluation  NewDataBrowserReceiveDragUPP

Under Evaluation  NewDataBrowserSelectContextualMenuUPP

Under Evaluation  NewDataBrowserTrackingUPP

Under Evaluation  OpenDataBrowserContainer

Unsupported  PreFilterEventProc

This QuickTime function for manipulating controls is not supported in Carbon.

Under Evaluation  RegisterControlDefinition

Supported  RemoveControlProperty

Under Evaluation  RemoveDataBrowserItems

Under Evaluation  RemoveDataBrowserTableViewColumn

Under Evaluation  RevealDataBrowserItem

Supported  ReverseKeyboardFocus

Supported  SendControlMessage

Under Evaluation  SetAutomaticControlDragTrackingEnabledForWindow

Supported  SetBevelButtonContentInfo

Supported  SetBevelButtonGraphicAlignment

Supported  SetBevelButtonMenuValue

Supported  SetBevelButtonTextAlignment

Supported  SetBevelButtonTextPlacement

Supported  SetBevelButtonTransform

Supported  SetControl32BitMaximum

Supported  SetControl32BitMinimum

Supported  SetControl32BitValue

Supported  SetControlAction

Supported  SetControlBounds

Unsupported  SetControlColor

Custom control color tables are not supported in Carbon.

Unsupported  SetControlColorTable

Custom control color tables are not supported in Carbon.

Supported  SetControlData

Supported  SetControlDataHandle

Unsupported  SetControlDefProc

This QuickTime function for manipulating controls is not supported in Carbon.

Under Evaluation  SetControlDragTrackingEnabled

Supported  SetControlFontStyle

Under Evaluation  SetControlID

Supported  SetControlMaximum

Supported  SetControlMinimum

Supported  SetControlOwner

Supported  SetControlPopupMenuHandle

Supported  SetControlPopupMenuID

Supported  SetControlProperty

Supported  SetControlReference

Supported  SetControlSupervisor

Supported  SetControlTitle

Unsupported  setcontroltitle

Use SetControlTitle instead.

Under Evaluation  SetControlTitleWithCFString

Supported  SetControlValue

Supported  SetControlViewSize

Supported  SetControlVisibility

Under Evaluation  SetDataBrowserActiveItems

Under Evaluation  SetDataBrowserCallbacks

Under Evaluation  SetDataBrowserCustomCallbacks

Under Evaluation  SetDataBrowserEditItem

Under Evaluation  SetDataBrowserHasScrollBars

Under Evaluation  SetDataBrowserItemDataBooleanValue

Under Evaluation  SetDataBrowserItemDataButtonValue

Under Evaluation  SetDataBrowserItemDataIcon

Under Evaluation  SetDataBrowserItemDataMaximum

Under Evaluation  SetDataBrowserItemDataMinimum

Under Evaluation  SetDataBrowserItemDataText

Under Evaluation  SetDataBrowserItemDataValue

Under Evaluation  SetDataBrowserListViewDisclosureColumn

Under Evaluation  SetDataBrowserListViewHeaderBtnHeight

Under Evaluation  SetDataBrowserListViewUsePlainBackground

Under Evaluation  SetDataBrowserScrollBarInset

Under Evaluation  SetDataBrowserScrollPosition

Under Evaluation  SetDataBrowserSelectedItems

Under Evaluation  SetDataBrowserSelectionFlags

Under Evaluation  SetDataBrowserSortOrder

Under Evaluation  SetDataBrowserSortProperty

Under Evaluation  SetDataBrowserTableViewColumnPosition

Under Evaluation  SetDataBrowserTableViewColumnWidth

Under Evaluation  SetDataBrowserTableViewGeometry

Under Evaluation  SetDataBrowserTableViewHiliteStyle

Under Evaluation  SetDataBrowserTableViewItemRow

Under Evaluation  SetDataBrowserTableViewItemRowHeight

Under Evaluation  SetDataBrowserTableViewNamedColumnWidth

Under Evaluation  SetDataBrowserTableViewRowHeight

Under Evaluation  SetDataBrowserTarget

Under Evaluation  SetDataBrowserUserState

Supported  SetDisclosureTriangleLastValue

Supported  SetImageWellContentInfo

Supported  SetImageWellTransform

Supported  SetKeyboardFocus

Unsupported  SetNextControl

The SetNextControl function is not supported in Carbon. Use the Control Manager's embedding hierarchy functions (CreateRootControl, GetRootControl, EmbedControl, AutoEmbedControl, GetSuperControl, GetIndexedSubControl, and SetControlSupervisor) to determine control ordering instead.

Supported  SetTabEnabled

Supported  SetUpControlBackground

Supported  SetUpControlTextColor

Supported  ShowControl

Supported  SizeControl

Under Evaluation  SortDataBrowserContainer

Supported  TestControl

Unsupported  testcontrol

Use TestControl instead.

Supported  TrackControl

Unsupported  trackcontrol

Use TrackControl instead.

Under Evaluation  UnflattenControl

Supported  UpdateControls

Under Evaluation  UpdateDataBrowserItems

[Table of Contents] [Manager Index] [Function Index]

Generated on: 10/6/99. Copyright 1999 Apple Computer, Inc. All rights reserved.